home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 2
/
Gold Medal Software Volume 2 (Gold Medal) (1994).iso
/
wordproc
/
ae.arj
/
AE.DOC
< prev
next >
Wrap
Text File
|
1993-04-25
|
5KB
|
137 lines
Assembler Editor 1.01 by Kip Irvine (AE.DOC)
DOCUMENTATION FOR THE ASSEMBLER EDITOR
I. INTRODUCTION
This editor was created using Borland Turbo Vision (tm) as a
multi-window popup editor for Kip Irvine's "Assembly Language
for the IBM-PC", 2nd Edition, 1993, Macmillan publishing Co.,
ISBN 0-02-359651-1.
You are welcome to use and distribute this editor free of charge.
You may not sell the editor for profit without the written consent
of Kip Irvine.
You should be able to use this editor with any assembler of your
choice. I have tested it with Borland's TASM 3.2 and Microsoft
MASM 5.1 There are installation options that let you set the
name and path of the assembler, linker, debugger, and link
library (if any).
Run the editor by typing its name and an optional name of
a file to be edited. A default extension of ASM is assumed.
Examples:
AE ; no file being edited
AE prog1 ; edits prog1.asm
AE myfile.dta ; edits myfile.dta
If you have any comments about the book or this editor, you are
welcome to send me a Compuserve EasyPlex message at 76137,2364,
or contact me at:
Kip Irvine
CIS Department, Rm. 2130
Miami-Dade Community College-Kendall
Miami, FL 33176
305/237-2806
Enjoy!
--Kip Irvine
II. INSTALLING THE PROGRAM PATHNAMES
The editor is shipped with a default configuration file (AE.CFG)
containing sample pathnames for the assembler, editor, linker, and
link library. Notice that you must include the extensions with the
executable filenames, but not with the link library name. No doubt
you will want to change these to suit your own directory setup:
Assembler path: C:\ASM\TASM.EXE
options: /z/zi
Linker path: C:\ASM\TLINK.EXE
options: /v
Debugger path: C:\ASM\TD.EXE
Library path: C:\ASM\CONSOLE
(The CONSOLE.LIB file is supplied on a disk with the Irvine book,
and is available in the Borland Turbo assembler forum on
Compuserve.)
To change these paths, select the "Set Path Names" option from
the "Run" menu. All changes are saved when exiting the editor.
The AE.CFG file is saved in the current directory, so if you're
working in various directories, copy AE.CFG to each directory.
III. EDITING A PROGRAM
Choose the "Open" command from the "File" menu to open an existing
source program. Or choose "New" from the same menu to create a new
program. The menu options conform to the standard CUA interface in
Borland's editors.
Be sure to save the file before assembling it, by pressing F2 (or
choose "Save As" from the "File" menu).
You may open multiple edit windows, each with a different source
file if you wish. Text may be cut and pasted between windows with
the mouse, or by marking text with the Shift-Arrow keys.
IV. ASSEMBLING A PROGRAM
If you have more than one window open, set the focus to the window
containing the program you want to assemble. You may do this by
pressing F6 to cycle through the windows to the desired one, or
you may click the mouse in the right window.
Choose "Assemble" from the "Run" menu. The assembler will take
over the screen until it is finished. Press a key to return to
the editor. If there were any errors or warnings, the editor will
remind you by displaying a dialog box with the error code number
returned by the assembler (this is the same as the ErrorLevel
number returned to a batch file).
V. LINKING A PROGRAM
Set the focus to the window containing the program you want to
link. If you are linking a multi-module program, the window
should contain the program's main module. Choose "Link" from the
"Run" menu. You will be prompted by a dialog for the names of
any link modules; if this is a single-module program, just press
Enter.
If there are other modules to be linked to the current program,
type their names with a space between each. Press Enter.
The linker will also attempt to link the link library file to
your program, in case you have specified any external modules
(using the EXTRN directive). If you have the book by Irvine,
the library would be CONSOLE.LIB. (See section II, "Installing
Program Pathnames" in this manual for directions on selecting
a link library.)
By the way, if your program doesn't use any external routines,
the link library will just be ignored by the linker.
VI. RUNNING THE PROGRAM
You can run your linked program just "as is" by choosing the
"Run" command from the "Run" menu. Or, you can run your program
with the debugger, by selecting "Debug" from the "Run" menu.
If you want to pass parameters to your program see the following
section, entitled "Setting Command-Line Parameters".
VII. SETTING COMMAND-LINE PARAMETERS
If you want to pass a command line to the program select the
"Parameters" option from the "Run" menu.